home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / dev / misc / BST_SystemDocs.lha / BeastV1 / Docs / BST_System / Methods.txt < prev    next >
Encoding:
Text File  |  1996-03-28  |  3.4 KB  |  98 lines
  1.  
  2. METHODS-ID
  3. ==========
  4.  
  5. Local methods, these method id's may be use by classes to define their own
  6. private methods, special care must be taken when doing so. Delegation of
  7. these throughout the parents or children can be dangerious, this because
  8. of BEAST is a dynamic system and therefore it is possible that several
  9. 'other' objects are inserted. And there could be a conflict because classes
  10. have the same method id defined for other uses.
  11. When developers are defining their own classes they can ask for a pre-
  12. defined 'slot' of methods which they can use. Send a message to
  13. weertj@IAEhv.nl.
  14. Developers however are strongly recommended to use the standard BEAST methods.
  15. In this way the classes have a similiar behaviour.
  16.  
  17.  
  18. Local methods
  19. -------------
  20.  
  21.     OBM_local0    ..    OBM_local0 + 0x40
  22.     OBM_local1    ..    OBM_local1 + 0x700
  23.     OBM_local2    ..    OBM_local2 + 0x1000
  24.     OBM_local3    ..    OBM_local3 + 0x1000000
  25.  
  26. The lower the method id number the higher priority it has.
  27.  
  28.  
  29. BEAST methods
  30. -------------
  31.  
  32. Now the general implementation of the BEAST is given, please note that
  33. this is _only_ the general description. These are the minimum demands
  34. the method must comply to. Every class can give a different implementation
  35. to the method as long as the general description is maintained.
  36.  
  37.     Priority high to low.
  38.  
  39.     OBM_INPUT    = The general input methods. No special treatment.
  40.     OBM_INPUT2    =
  41.     OBM_INPUT3    =
  42.     OBM_INPUT4    =
  43.     OBM_OUTPUT    = The general output methods. No special treatment.
  44.     OBM_OUTPUT2    =
  45.     OBM_OUTPUT3    =
  46.     OBM_OUTPUT4    =
  47.  
  48.     OBM_SYSINPUT    = BEAST system input, do not use this method.
  49.     OBM_SYSOUTPUT    = BEAST system output, do not use this method.
  50.  
  51.     OBM_IDCMPINPUT    = IDCMP input method.
  52.     OBM_IDCMPOUTPUT    = IDCMP output method.
  53.               These two methods are used by BeaVis classes.
  54.     OBM_BVSINPUT    = BeaVis input method.
  55.     OBM_BVSOUTPUT    = BeaVis output method
  56.               These two methods are used by BeaVis classes.
  57.     OBM_BEAMMINPUT    = BeaMM input method.
  58.     OBM_BEAMMOUTPUT = BeaMM output method.
  59.               These two methods are used by BeaMM classes.
  60.     OBM_BFSINPUT    = BFS input method.
  61.     OBM_BFSOUTPUT    = BFS output method.
  62.               These two methods are used by BFS classes.
  63.  
  64.     OBM_INIT    = General init method.
  65.               TagList requirements equals the OBM_SETATTR method.
  66.     OBM_DISPOSE    = General dispose method.
  67.     OBM_SETATTR    = General method to set instance fields.
  68.               
  69.     OBM_GETATTR    = General method to get instance fields.
  70.  
  71.  
  72. MethodFlags
  73. ===========
  74.     MethodFlags are the 'controls' of the methods.
  75.  
  76.     MTH_DOPARENTS      = Delegate method through the parent objects.
  77.               The method is also triggered at the parent objects
  78.               this will continue until one method routine resets
  79.               this flags.
  80.     MTH_DOCHILDREN     = Delegate method through childern bottom up.
  81.               The method is first triggered at the 'lowest'
  82.               object in the tree, those with no children.
  83.     MTH_PASSTOCHILD    = Delegate method through children top down.
  84.               Now the method is triggered first at the childern.
  85.               A method can reset this flag to prevent it's children
  86.               being called.
  87.     MTH_ERROR    = There has been occured an error, but it is not
  88.               fatal. If the object has the OBM_ERROR method
  89.               implemented this can be used to find out what went
  90.               wrong.
  91.     MTH_FATALERROR    = There has occured a fatal error. Mostly this means
  92.               that the object is instable.
  93.     MTH_BREAK    = Don't execute the method, this flag is mostly used by
  94.               superclasses. (Method overriding).
  95.  
  96.     MTH_B52_bits    = The mask of the bits which are defined by B52.
  97.  
  98.